Ektron CMS400.Net Reference

>>Conducting eCommerce with Ektron CMS400.NET > Configuration Screens > Currencies > CurrencySelect Server Control

CurrencySelect Server Control

Warning! In addition to reading this section on the CurrencySelect server controls, Ektron strongly recommends reading Currencies.

The Currency server control allows site visitors to select the monetary type they will use to make purchases. Once the site visitor selects his currency, all eCommerce server controls use it for that order. If a site visitor closes the browser, the currency will need to be selected the next time he visits the site.

For a currency to appear in the CurrencySelect server control, it must be enabled in the Ektron CMS400.NET Workarea > Settings > Commerce > Currencies screen. To enable a currency, click its name in the list and place a check in the enable checkbox. Next, click Save ().

CurrencySelect Server Control Properties

The following table explains the properties of the CurrencySelect control.

Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.

Property

Description

Data Type

Authenticated

Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc. See Also: Working with Ektron CMS400.NET Server Controls

String

CacheInterval

Sets the amount of time the server control’s data is cached. The default is 0 (zero). This is the amount of time, in seconds, a control’s data is cached. For example, if you want to cache the data for five minutes, set the CacheInterval property to 300 (three hundred). See Also: Caching with Server Controls

Double

CustomXml

(Code Behind Only)

Provides a mechanism to inject custom XML into the generated XML before being processed by the XSLT. The injected XML is appended to the end of the XML produced by this control.

See Also: Displaying Custom XML in Ektron’s Server Controls

String

DisplayXslt

Specify an external XSLT file to render the control. By default, the control uses CurrencySelect.xsl. This file is located in
<Site Root>\Workarea\Xslt\Commerce

Important: If you want to edit this file, it is strongly recommended that you make a copy, change its name and move it outside your site’s Workarea folder. If you make changes to this file and do not move it out of the Workarea folder, this file and the changes will be lost when you upgrade.

String

 

DoInitFill

By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, FIll is automatically called during the Page Render event.

You might do this if you need to set or change a property on the control in codebehind and have it render with your changes shown.

Boolean

Hide

Used to hide the control in design time and run time.

True = Hide the control

False = Show the control

Boolean

Language

Set a language for viewing the currency selection tool. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

Integer

Stylesheet

Specify the path to a style sheet for use with this server control. The location can be relative or absolute. Leave blank to use the default style sheet.

String

SuppressWrapperTags

Suppresses the output of the span/div tags around the control. The default is False.

True - Suppress wrap tags.

False - Allow wrap tags.

Boolean


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.